<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Closures</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="GObject Reference Manual">
<link rel="up" href="rn01.html" title="API Reference">
<link rel="prev" href="gobject-Signals.html" title="Signals">
<link rel="next" href="gobject-Value-arrays.html" title="Value arrays">
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="preface" href="pr01.html" title="Introduction">
<link rel="part" href="pt01.html" title="Part&#160;I.&#160;Concepts">
<link rel="chapter" href="chapter-intro.html" title="Background">
<link rel="chapter" href="chapter-gtype.html" title="The GLib Dynamic Type System">
<link rel="chapter" href="chapter-gobject.html" title="The GObject base class">
<link rel="chapter" href="chapter-signal.html" title="The GObject messaging system">
<link rel="reference" href="rn01.html" title="API Reference">
<link rel="reference" href="rn02.html" title="Tools Reference">
<link rel="part" href="pt02.html" title="Part&#160;IV.&#160;Tutorial">
<link rel="chapter" href="howto-gobject.html" title="How to define and implement a new GObject">
<link rel="chapter" href="howto-interface.html" title="How to define and implement interfaces">
<link rel="chapter" href="howto-signals.html" title="How to create and use signals">
<link rel="part" href="pt03.html" title="Part&#160;V.&#160;Related Tools">
<link rel="chapter" href="tools-gob.html" title="GObject builder">
<link rel="chapter" href="tools-ginspector.html" title="Graphical inspection of GObjects">
<link rel="chapter" href="tools-refdb.html" title="Debugging reference count problems">
<link rel="chapter" href="tools-gtkdoc.html" title="Writing API docs">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
<link rel="index" href="ix08.html" title="Index of new symbols in 2.12">
<link rel="index" href="ix09.html" title="Index of new symbols in 2.14">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gobject-Signals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GObject Reference Manual</th>
<td><a accesskey="n" href="gobject-Value-arrays.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2973047" class="shortcut">Top</a>
                  &#160;|&#160;
                  <a href="#id2975182" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="gobject-Closures"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2973047"></a><span class="refentrytitle">Closures</span>
</h2>
<p>Closures &#8212; Functions as first-class objects</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;glib-object.h&gt;


#define             <a class="link" href="gobject-Closures.html#G-CLOSURE-NEEDS-MARSHAL:CAPS">G_CLOSURE_NEEDS_MARSHAL</a>             (closure)
#define             <a class="link" href="gobject-Closures.html#G-CLOSURE-N-NOTIFIERS:CAPS">G_CLOSURE_N_NOTIFIERS</a>               (cl)
#define             <a class="link" href="gobject-Closures.html#G-CCLOSURE-SWAP-DATA:CAPS">G_CCLOSURE_SWAP_DATA</a>                (cclosure)
#define             <a class="link" href="gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a>                          (f)
void                (<a class="link" href="gobject-Closures.html#GCallback">*GCallback</a>)                        (void);
                    <a class="link" href="gobject-Closures.html#GClosure">GClosure</a>;
#define             <a class="link" href="gobject-Closures.html#G-TYPE-CLOSURE:CAPS">G_TYPE_CLOSURE</a>
                    <a class="link" href="gobject-Closures.html#GCClosure">GCClosure</a>;
void                (<a class="link" href="gobject-Closures.html#GClosureMarshal">*GClosureMarshal</a>)                  (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                (<a class="link" href="gobject-Closures.html#GClosureNotify">*GClosureNotify</a>)                   (<a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
                                                         <a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);
<a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           <a class="link" href="gobject-Closures.html#g-cclosure-new">g_cclosure_new</a>                      (<a class="link" href="gobject-Closures.html#GCallback">GCallback</a> callback_func,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> destroy_data);
<a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           <a class="link" href="gobject-Closures.html#g-cclosure-new-swap">g_cclosure_new_swap</a>                 (<a class="link" href="gobject-Closures.html#GCallback">GCallback</a> callback_func,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> destroy_data);
<a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           <a class="link" href="gobject-Closures.html#g-cclosure-new-object">g_cclosure_new_object</a>               (<a class="link" href="gobject-Closures.html#GCallback">GCallback</a> callback_func,
                                                         <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object);
<a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           <a class="link" href="gobject-Closures.html#g-cclosure-new-object-swap">g_cclosure_new_object_swap</a>          (<a class="link" href="gobject-Closures.html#GCallback">GCallback</a> callback_func,
                                                         <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object);
<a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           <a class="link" href="gobject-Closures.html#g-closure-new-object">g_closure_new_object</a>                (<a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> sizeof_closure,
                                                         <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object);
<a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           <a class="link" href="gobject-Closures.html#g-closure-ref">g_closure_ref</a>                       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);
void                <a class="link" href="gobject-Closures.html#g-closure-sink">g_closure_sink</a>                      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);
void                <a class="link" href="gobject-Closures.html#g-closure-unref">g_closure_unref</a>                     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);
void                <a class="link" href="gobject-Closures.html#g-closure-invoke">g_closure_invoke</a>                    (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint);
void                <a class="link" href="gobject-Closures.html#g-closure-invalidate">g_closure_invalidate</a>                (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);
void                <a class="link" href="gobject-Closures.html#g-closure-add-finalize-notifier">g_closure_add_finalize_notifier</a>     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> notify_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> notify_func);
void                <a class="link" href="gobject-Closures.html#g-closure-add-invalidate-notifier">g_closure_add_invalidate_notifier</a>   (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> notify_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> notify_func);
void                <a class="link" href="gobject-Closures.html#g-closure-remove-finalize-notifier">g_closure_remove_finalize_notifier</a>  (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> notify_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> notify_func);
void                <a class="link" href="gobject-Closures.html#g-closure-remove-invalidate-notifier">g_closure_remove_invalidate_notifier</a>
                                                        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> notify_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> notify_func);
<a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           <a class="link" href="gobject-Closures.html#g-closure-new-simple">g_closure_new_simple</a>                (<a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> sizeof_closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);
void                <a class="link" href="gobject-Closures.html#g-closure-set-marshal">g_closure_set_marshal</a>               (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Closures.html#GClosureMarshal">GClosureMarshal</a> marshal);
void                <a class="link" href="gobject-Closures.html#g-closure-add-marshal-guards">g_closure_add_marshal_guards</a>        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> pre_marshal_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> pre_marshal_notify,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> post_marshal_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> post_marshal_notify);
void                <a class="link" href="gobject-Closures.html#g-closure-set-meta-marshal">g_closure_set_meta_marshal</a>          (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureMarshal">GClosureMarshal</a> meta_marshal);
void                <a class="link" href="gobject-Closures.html#g-source-set-closure">g_source_set_closure</a>                (<a
href="./../glib/glib/glib-The-Main-Event-Loop.html#GSource"
>GSource</a> *source,
                                                         <a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);
#define             <a class="link" href="gobject-Closures.html#G-TYPE-IO-CHANNEL:CAPS">G_TYPE_IO_CHANNEL</a>
#define             <a class="link" href="gobject-Closures.html#G-TYPE-IO-CONDITION:CAPS">G_TYPE_IO_CONDITION</a>

void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--VOID">g_cclosure_marshal_VOID__VOID</a>       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--BOOLEAN">g_cclosure_marshal_VOID__BOOLEAN</a>    (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--CHAR">g_cclosure_marshal_VOID__CHAR</a>       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--UCHAR">g_cclosure_marshal_VOID__UCHAR</a>      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--INT">g_cclosure_marshal_VOID__INT</a>        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--UINT">g_cclosure_marshal_VOID__UINT</a>       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--LONG">g_cclosure_marshal_VOID__LONG</a>       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--ULONG">g_cclosure_marshal_VOID__ULONG</a>      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--ENUM">g_cclosure_marshal_VOID__ENUM</a>       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--FLAGS">g_cclosure_marshal_VOID__FLAGS</a>      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--FLOAT">g_cclosure_marshal_VOID__FLOAT</a>      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--DOUBLE">g_cclosure_marshal_VOID__DOUBLE</a>     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--STRING">g_cclosure_marshal_VOID__STRING</a>     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--PARAM">g_cclosure_marshal_VOID__PARAM</a>      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--BOXED">g_cclosure_marshal_VOID__BOXED</a>      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--POINTER">g_cclosure_marshal_VOID__POINTER</a>    (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--OBJECT">g_cclosure_marshal_VOID__OBJECT</a>     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-STRING--OBJECT-POINTER">g_cclosure_marshal_STRING__OBJECT_POINTER</a>
                                                        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-VOID--UINT-POINTER">g_cclosure_marshal_VOID__UINT_POINTER</a>
                                                        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
void                <a class="link" href="gobject-Closures.html#g-cclosure-marshal-BOOLEAN--FLAGS">g_cclosure_marshal_BOOLEAN__FLAGS</a>   (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);
#define             <a class="link" href="gobject-Closures.html#g-cclosure-marshal-BOOL--FLAGS">g_cclosure_marshal_BOOL__FLAGS</a>

</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2975182"></a><h2>Description</h2>
<p>
A <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> represents a callback supplied by the programmer. It will generally
comprise a function of some kind and a marshaller used to call it. It is the 
reponsibility of the marshaller to convert the arguments for the invocation 
from <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>s into a suitable form, perform the callback on the 
converted arguments, and transform the return value back into a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
</p>
<p>
In the case of C programs, a closure usually just holds a pointer to a function
and maybe a data argument, and the marshaller converts between <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
and native C types. The GObject library provides the <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> type for this
purpose. Bindings for other languages need marshallers which 
convert between <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>s and suitable representations in the runtime
of the language in order to use functions written in that languages as 
callbacks.
</p>
<p>
Within GObject, closures play an important role in the implementation of 
signals. When a signal is registered, the <em class="parameter"><code>c_marshaller</code></em> argument to 
<a class="link" href="gobject-Signals.html#g-signal-new"><code class="function">g_signal_new()</code></a> specifies the default C marshaller for any closure which is 
connected to this signal. GObject provides a number of C marshallers  
for this purpose, see the g_cclosure_marshal_*() functions. Additional
C marshallers can be generated with the <a class="link" href="glib-genmarshal.html" title="glib-genmarshal">glib-genmarshal</a> utility.
Closures can be explicitly connected to signals with 
<a class="link" href="gobject-Signals.html#g-signal-connect-closure"><code class="function">g_signal_connect_closure()</code></a>, but it usually more convenient to let GObject 
create a closure automatically by using one of the g_signal_connect_*() 
functions which take a callback function/user data pair.
</p>
<p>
Using closures has a number of important advantages over a simple
callback function/data pointer combination:
</p>
<div class="itemizedlist"><ul type="disc">
<li><p>
Closures allow the callee to get the types of the callback parameters, 
which means that language bindings don't have to write individual glue 
for each callback type.
</p></li>
<li><p>
The reference counting of <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> makes it easy to handle reentrancy 
right; if a callback is removed while it is being invoked, the closure 
and it's parameters won't be freed until the invocation finishes. 
</p></li>
<li><p>
<a class="link" href="gobject-Closures.html#g-closure-invalidate"><code class="function">g_closure_invalidate()</code></a> and invalidation notifiers allow callbacks to be
automatically removed when the objects they point to go away.
</p></li>
</ul></div>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2975362"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2975372"></a><h3>
<a name="G-CLOSURE-NEEDS-MARSHAL:CAPS"></a>G_CLOSURE_NEEDS_MARSHAL()</h3>
<a class="indexterm" name="id2975386"></a><pre class="programlisting">#define	G_CLOSURE_NEEDS_MARSHAL(closure) (((GClosure*) (closure))-&gt;marshal == NULL)
</pre>
<p>
Returns <a
href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if a <a class="link" href="gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> marshaller has not yet been set on 
<em class="parameter"><code>closure</code></em>. See <a class="link" href="gobject-Closures.html#g-closure-set-marshal"><code class="function">g_closure_set_marshal()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2975466"></a><h3>
<a name="G-CLOSURE-N-NOTIFIERS:CAPS"></a>G_CLOSURE_N_NOTIFIERS()</h3>
<a class="indexterm" name="id2975479"></a><pre class="programlisting">#define             G_CLOSURE_N_NOTIFIERS(cl)</pre>
<p>
Returns the total number of notifiers connected with the closure <em class="parameter"><code>cl</code></em>. 
The count includes the meta marshaller, the finalize and invalidate notifiers 
and the marshal guards. Note that each guard counts as two notifiers. 
See <a class="link" href="gobject-Closures.html#g-closure-set-meta-marshal"><code class="function">g_closure_set_meta_marshal()</code></a>, <a class="link" href="gobject-Closures.html#g-closure-add-finalize-notifier"><code class="function">g_closure_add_finalize_notifier()</code></a>,
<a class="link" href="gobject-Closures.html#g-closure-add-invalidate-notifier"><code class="function">g_closure_add_invalidate_notifier()</code></a> and <a class="link" href="gobject-Closures.html#g-closure-add-marshal-guards"><code class="function">g_closure_add_marshal_guards()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>cl</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2975574"></a><h3>
<a name="G-CCLOSURE-SWAP-DATA:CAPS"></a>G_CCLOSURE_SWAP_DATA()</h3>
<a class="indexterm" name="id2975587"></a><pre class="programlisting">#define	G_CCLOSURE_SWAP_DATA(cclosure)	 (((GClosure*) (cclosure))-&gt;derivative_flag)
</pre>
<p>
Returns whether the user data of the <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> should be passed as the
first parameter to the callback. See <a class="link" href="gobject-Closures.html#g-cclosure-new-swap"><code class="function">g_cclosure_new_swap()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>cclosure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a>


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2975650"></a><h3>
<a name="G-CALLBACK:CAPS"></a>G_CALLBACK()</h3>
<a class="indexterm" name="id2975663"></a><pre class="programlisting">#define	G_CALLBACK(f)			 ((GCallback) (f))
</pre>
<p>
Cast a function pointer to a <a class="link" href="gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em>&#160;:</span></p></td>
<td>a function pointer.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2975706"></a><h3>
<a name="GCallback"></a>GCallback ()</h3>
<a class="indexterm" name="id2975718"></a><pre class="programlisting">void                (*GCallback)                        (void);</pre>
<p>
The type used for callback functions in structure definitions and function 
signatures. This doesn't mean that all callback functions must take no 
parameters and return void. The required signature of a callback function 
is determined by the context in which is used (e.g. the signal to which it 
is connected). Use <a class="link" href="gobject-Closures.html#G-CALLBACK:CAPS"><code class="function">G_CALLBACK()</code></a> to cast the callback function to a <a class="link" href="gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>. 
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2975764"></a><h3>
<a name="GClosure"></a>GClosure</h3>
<a class="indexterm" name="id2975776"></a><pre class="programlisting">typedef struct {
  volatile       	guint	 in_marshal : 1;
  volatile       	guint	 is_invalid : 1;
} GClosure;
</pre>
<p>
A <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> represents a callback supplied by the programmer.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term">volatile&#160;&#160;&#160;&#160;&#160;&#160;&#160;	<a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a>&#160;<em class="structfield"><code>in_marshal</code></em>&#160;:&#160;1;</span></p></td>
<td>Indicates whether the closure is currently being invoked with 
  <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term">volatile&#160;&#160;&#160;&#160;&#160;&#160;&#160;	<a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a>&#160;<em class="structfield"><code>is_invalid</code></em>&#160;:&#160;1;</span></p></td>
<td>Indicates whether the closure has been invalidated by 
  <a class="link" href="gobject-Closures.html#g-closure-invalidate"><code class="function">g_closure_invalidate()</code></a>

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2975873"></a><h3>
<a name="G-TYPE-CLOSURE:CAPS"></a>G_TYPE_CLOSURE</h3>
<a class="indexterm" name="id2975886"></a><pre class="programlisting">#define	G_TYPE_CLOSURE		(g_closure_get_type ())
</pre>
<p>
The <a class="link" href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> for <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2975918"></a><h3>
<a name="GCClosure"></a>GCClosure</h3>
<a class="indexterm" name="id2975930"></a><pre class="programlisting">typedef struct {
  GClosure	closure;
  gpointer	callback;
} GCClosure;
</pre>
<p>
A <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> is a specialization of <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> for C function callbacks.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a class="link" href="gobject-Closures.html#GClosure">GClosure</a>&#160;<em class="structfield"><code>closure</code></em>;</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>&#160;<em class="structfield"><code>callback</code></em>;</span></p></td>
<td>the callback function

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2976015"></a><h3>
<a name="GClosureMarshal"></a>GClosureMarshal ()</h3>
<a class="indexterm" name="id2976028"></a><pre class="programlisting">void                (*GClosureMarshal)                  (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
The type used for marshaller functions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to store the return value. May be <a
href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if the
  callback of <em class="parameter"><code>closure</code></em> doesn't return a value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>the length of the <em class="parameter"><code>param_values</code></em> array
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>an array of <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>s holding the arguments on
  which to invoke the callback of <em class="parameter"><code>closure</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller,
  see <a class="link" href="gobject-Closures.html#g-closure-set-marshal"><code class="function">g_closure_set_marshal()</code></a> and <a class="link" href="gobject-Closures.html#g-closure-set-meta-marshal"><code class="function">g_closure_set_meta_marshal()</code></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2976275"></a><h3>
<a name="GClosureNotify"></a>GClosureNotify ()</h3>
<a class="indexterm" name="id2976288"></a><pre class="programlisting">void                (*GClosureNotify)                   (<a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
                                                         <a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);</pre>
<p>
The type used for the various notification callbacks which can be registered
on closures.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>data specified when registering the notification callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> on which the notification is emitted


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2976366"></a><h3>
<a name="g-cclosure-new"></a>g_cclosure_new ()</h3>
<a class="indexterm" name="id2976379"></a><pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           g_cclosure_new                      (<a class="link" href="gobject-Closures.html#GCallback">GCallback</a> callback_func,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> destroy_data);</pre>
<p>
Creates a new closure which invokes <em class="parameter"><code>callback_func</code></em> with <em class="parameter"><code>user_data</code></em> as 
the last parameter. 
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_func</code></em>&#160;:</span></p></td>
<td>the function to invoke
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data to pass to <em class="parameter"><code>callback_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em>&#160;:</span></p></td>
<td>destroy notify to be called when <em class="parameter"><code>user_data</code></em> is no longer used
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a new <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2976514"></a><h3>
<a name="g-cclosure-new-swap"></a>g_cclosure_new_swap ()</h3>
<a class="indexterm" name="id2976528"></a><pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           g_cclosure_new_swap                 (<a class="link" href="gobject-Closures.html#GCallback">GCallback</a> callback_func,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> destroy_data);</pre>
<p>
Creates a new closure which invokes <em class="parameter"><code>callback_func</code></em> with <em class="parameter"><code>user_data</code></em> as 
the first parameter. 
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_func</code></em>&#160;:</span></p></td>
<td>the function to invoke
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data to pass to <em class="parameter"><code>callback_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>destroy_data</code></em>&#160;:</span></p></td>
<td>destroy notify to be called when <em class="parameter"><code>user_data</code></em> is no longer used
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a new <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2976662"></a><h3>
<a name="g-cclosure-new-object"></a>g_cclosure_new_object ()</h3>
<a class="indexterm" name="id2976675"></a><pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           g_cclosure_new_object               (<a class="link" href="gobject-Closures.html#GCallback">GCallback</a> callback_func,
                                                         <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object);</pre>
<p>
A variant of <a class="link" href="gobject-Closures.html#g-cclosure-new"><code class="function">g_cclosure_new()</code></a> which uses <em class="parameter"><code>object</code></em> as <em class="parameter"><code>user_data</code></em> and calls 
<a class="link" href="gobject-The-Base-Object-Type.html#g-object-watch-closure"><code class="function">g_object_watch_closure()</code></a> on <em class="parameter"><code>object</code></em> and the created closure. This function 
is useful when you have a callback closely associated with a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>,
and want the callback to no longer run after the object is is freed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_func</code></em>&#160;:</span></p></td>
<td>the function to invoke
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> pointer to pass to <em class="parameter"><code>callback_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a new <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2976827"></a><h3>
<a name="g-cclosure-new-object-swap"></a>g_cclosure_new_object_swap ()</h3>
<a class="indexterm" name="id2976841"></a><pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           g_cclosure_new_object_swap          (<a class="link" href="gobject-Closures.html#GCallback">GCallback</a> callback_func,
                                                         <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object);</pre>
<p>
A variant of <a class="link" href="gobject-Closures.html#g-cclosure-new-swap"><code class="function">g_cclosure_new_swap()</code></a> which uses <em class="parameter"><code>object</code></em> as <em class="parameter"><code>user_data</code></em> and calls 
<a class="link" href="gobject-The-Base-Object-Type.html#g-object-watch-closure"><code class="function">g_object_watch_closure()</code></a> on <em class="parameter"><code>object</code></em> and the created closure. This function 
is useful when you have a callback closely associated with a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>,
and want the callback to no longer run after the object is is freed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_func</code></em>&#160;:</span></p></td>
<td>the function to invoke
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> pointer to pass to <em class="parameter"><code>callback_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a new <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2976992"></a><h3>
<a name="g-closure-new-object"></a>g_closure_new_object ()</h3>
<a class="indexterm" name="id2977006"></a><pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           g_closure_new_object                (<a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> sizeof_closure,
                                                         <a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a> *object);</pre>
<p>
A variant of <a class="link" href="gobject-Closures.html#g-closure-new-simple"><code class="function">g_closure_new_simple()</code></a> which stores <em class="parameter"><code>object</code></em> in the <em class="parameter"><code>data</code></em>
field of the closure and calls <a class="link" href="gobject-The-Base-Object-Type.html#g-object-watch-closure"><code class="function">g_object_watch_closure()</code></a> on <em class="parameter"><code>object</code></em> and the 
created closure. This function is mainly useful when implementing new types 
of closures.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>sizeof_closure</code></em>&#160;:</span></p></td>
<td>the size of the structure to allocate, must be at least 
<code class="literal">sizeof (GClosure)</code>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> pointer to store in the <em class="parameter"><code>data</code></em> field of the newly 
  allocated <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a newly allocated <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2977164"></a><h3>
<a name="g-closure-ref"></a>g_closure_ref ()</h3>
<a class="indexterm" name="id2977176"></a><pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           g_closure_ref                       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);</pre>
<p>
Increments the reference count on a closure to force it staying
alive while the caller holds a pointer to it.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>
<a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to increment the reference count on
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>The <em class="parameter"><code>closure</code></em> passed in, for convenience


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2977249"></a><h3>
<a name="g-closure-sink"></a>g_closure_sink ()</h3>
<a class="indexterm" name="id2977262"></a><pre class="programlisting">void                g_closure_sink                      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);</pre>
<p>
Takes over the initial ownership of a closure.
Each closure is initially created in a <em class="firstterm">floating</em> state, 
which means that the initial reference count is not owned by any caller. 
<a class="link" href="gobject-Closures.html#g-closure-sink"><code class="function">g_closure_sink()</code></a> checks to see if the object is still floating, and if so, 
unsets the floating state and decreases the reference count. If the closure 
is not floating, <a class="link" href="gobject-Closures.html#g-closure-sink"><code class="function">g_closure_sink()</code></a> does nothing. The reason for the existance 
of the floating state is to prevent cumbersome code sequences like: 
</p>
<pre class="programlisting">
closure = g_cclosure_new (cb_func, cb_data); 
g_source_set_closure (source, closure); 
g_closure_unref (closure); /* XXX GObject doesn't really need this */
</pre>
<p>
Because <a class="link" href="gobject-Closures.html#g-source-set-closure"><code class="function">g_source_set_closure()</code></a> (and similar functions) take ownership of the 
initial reference count, if it is unowned, we instead can write: 
</p>
<pre class="programlisting">
g_source_set_closure (source, g_cclosure_new (cb_func, cb_data));
</pre>
<p>
</p>
<p>
Generally, this function is used together with <a class="link" href="gobject-Closures.html#g-closure-ref"><code class="function">g_closure_ref()</code></a>. Ane example 
of storing a closure for later notification looks like:
</p>
<div class="informalexample"><pre class="programlisting">
static GClosure *notify_closure = NULL;
void
foo_notify_set_closure (GClosure *closure)
{
  if (notify_closure)
    g_closure_unref (notify_closure);
  notify_closure = closure;
  if (notify_closure)
    {
      g_closure_ref (notify_closure);
      g_closure_sink (notify_closure);
    }
}
</pre></div>
<p>
</p>
<p>
Because <a class="link" href="gobject-Closures.html#g-closure-sink"><code class="function">g_closure_sink()</code></a> may decrement the reference count of a closure
(if it hasn't been called on <em class="parameter"><code>closure</code></em> yet) just like <a class="link" href="gobject-Closures.html#g-closure-unref"><code class="function">g_closure_unref()</code></a>,
<a class="link" href="gobject-Closures.html#g-closure-ref"><code class="function">g_closure_ref()</code></a> should be called prior to this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>
<a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to decrement the initial reference count on, if it's
          still being held


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2977447"></a><h3>
<a name="g-closure-unref"></a>g_closure_unref ()</h3>
<a class="indexterm" name="id2977460"></a><pre class="programlisting">void                g_closure_unref                     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);</pre>
<p>
Decrements the reference count of a closure after it was previously 
incremented by the same caller. If no other callers are using the closure,
then the closure will be destroyed and freed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>
<a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to decrement the reference count on


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2977517"></a><h3>
<a name="g-closure-invoke"></a>g_closure_invoke ()</h3>
<a class="indexterm" name="id2977530"></a><pre class="programlisting">void                g_closure_invoke                    (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint);</pre>
<p>
Invokes the closure, i.e. executes the callback represented by the <em class="parameter"><code>closure</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to store the return value. May be <a
href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if the
  callback of <em class="parameter"><code>closure</code></em> doesn't return a value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>the length of the <em class="parameter"><code>param_values</code></em> array
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>an array of <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>s holding the arguments on
  which to invoke the callback of <em class="parameter"><code>closure</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>a context-dependent invocation hint


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2977726"></a><h3>
<a name="g-closure-invalidate"></a>g_closure_invalidate ()</h3>
<a class="indexterm" name="id2977740"></a><pre class="programlisting">void                g_closure_invalidate                (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);</pre>
<p>
Sets a flag on the closure to indicate that it's calling environment has 
become invalid, and thus causes any future invocations of <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a> 
on this <em class="parameter"><code>closure</code></em> to be ignored. Also, invalidation notifiers installed on 
the closure will be called at this point. Note that unless you are holding 
a reference to the closure yourself, the invalidation notifiers may unref 
the closure and cause it to be destroyed, so if you need to access the 
closure after calling <a class="link" href="gobject-Closures.html#g-closure-invalidate"><code class="function">g_closure_invalidate()</code></a>, make sure that you've 
previously called <a class="link" href="gobject-Closures.html#g-closure-ref"><code class="function">g_closure_ref()</code></a>.
</p>
<p>
Note that <a class="link" href="gobject-Closures.html#g-closure-invalidate"><code class="function">g_closure_invalidate()</code></a> will also be called when the reference count
of a closure drops to zero (unless it has already been invalidated before).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>GClosure to invalidate


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2977849"></a><h3>
<a name="g-closure-add-finalize-notifier"></a>g_closure_add_finalize_notifier ()</h3>
<a class="indexterm" name="id2977862"></a><pre class="programlisting">void                g_closure_add_finalize_notifier     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> notify_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> notify_func);</pre>
<p>
Registers a finalization notifier which will be called when the reference
count of <em class="parameter"><code>closure</code></em> goes down to 0. Multiple finalization notifiers on a 
single closure are invoked in unspecified order. If a single call to 
<a class="link" href="gobject-Closures.html#g-closure-unref"><code class="function">g_closure_unref()</code></a> results in the closure being both invalidated and 
finalized, then the invalidate notifiers will be run before the finalize 
notifiers.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify_data</code></em>&#160;:</span></p></td>
<td>data to pass to <em class="parameter"><code>notify_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify_func</code></em>&#160;:</span></p></td>
<td>the callback function to register


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2977989"></a><h3>
<a name="g-closure-add-invalidate-notifier"></a>g_closure_add_invalidate_notifier ()</h3>
<a class="indexterm" name="id2978004"></a><pre class="programlisting">void                g_closure_add_invalidate_notifier   (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> notify_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> notify_func);</pre>
<p>
Registers an invalidation notifier which will be called when the <em class="parameter"><code>closure</code></em>
is invalidated with <a class="link" href="gobject-Closures.html#g-closure-invalidate"><code class="function">g_closure_invalidate()</code></a>. Invalidation notifiers are 
invoked before finalization notifiers, in an unspecified order.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify_data</code></em>&#160;:</span></p></td>
<td>data to pass to <em class="parameter"><code>notify_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify_func</code></em>&#160;:</span></p></td>
<td>the callback function to register


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2978128"></a><h3>
<a name="g-closure-remove-finalize-notifier"></a>g_closure_remove_finalize_notifier ()</h3>
<a class="indexterm" name="id2978142"></a><pre class="programlisting">void                g_closure_remove_finalize_notifier  (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> notify_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> notify_func);</pre>
<p>
Removes a finalization notifier.
</p>
<p>
Notice that notifiers are automatically removed after they are run.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify_data</code></em>&#160;:</span></p></td>
<td>data which was passed to <a class="link" href="gobject-Closures.html#g-closure-add-finalize-notifier"><code class="function">g_closure_add_finalize_notifier()</code></a>
 when registering <em class="parameter"><code>notify_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify_func</code></em>&#160;:</span></p></td>
<td>the callback function to remove


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2978263"></a><h3>
<a name="g-closure-remove-invalidate-notifier"></a>g_closure_remove_invalidate_notifier ()</h3>
<a class="indexterm" name="id2978277"></a><pre class="programlisting">void                g_closure_remove_invalidate_notifier
                                                        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> notify_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> notify_func);</pre>
<p>
Removes an invalidation notifier.
</p>
<p>
Notice that notifiers are automatically removed after they are run.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify_data</code></em>&#160;:</span></p></td>
<td>data which was passed to <a class="link" href="gobject-Closures.html#g-closure-add-invalidate-notifier"><code class="function">g_closure_add_invalidate_notifier()</code></a>
 when registering <em class="parameter"><code>notify_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify_func</code></em>&#160;:</span></p></td>
<td>the callback function to remove


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2978400"></a><h3>
<a name="g-closure-new-simple"></a>g_closure_new_simple ()</h3>
<a class="indexterm" name="id2978413"></a><pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure">GClosure</a>*           g_closure_new_simple                (<a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> sizeof_closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
Allocates a struct of the given size and initializes the initial part
as a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>. This function is mainly useful when implementing new types 
of closures.
</p>
<div class="informalexample"><pre class="programlisting">
typedef struct _MyClosure MyClosure;
struct _MyClosure 
{
  GClosure closure;
  /* extra data goes here */
};
    

static void
my_closure_finalize (gpointer  notify_data, 
                     GClosure *closure)
{
  MyClosure *my_closure = (MyClosure *)closure;

  /* free extra data here */
}

MyClosure *my_closure_new (gpointer data)
{
  GClosure *closure;
  MyClosure *my_closure;
  
  closure = g_closure_new_simple (sizeof (MyClosure), data);
  my_closure = (MyClosure *) closure;

  / initialize extra data here */

  g_closure_add_finalize_notifier (closure, notify_data,
                                   my_closure_finalize);
  return my_closure;
}
</pre></div>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>sizeof_closure</code></em>&#160;:</span></p></td>
<td>the size of the structure to allocate, must be at least 
<code class="literal">sizeof (GClosure)</code>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>data to store in the <em class="parameter"><code>data</code></em> field of the newly allocated <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a newly allocated <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2978551"></a><h3>
<a name="g-closure-set-marshal"></a>g_closure_set_marshal ()</h3>
<a class="indexterm" name="id2978564"></a><pre class="programlisting">void                g_closure_set_marshal               (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Closures.html#GClosureMarshal">GClosureMarshal</a> marshal);</pre>
<p>
Sets the marshaller of <em class="parameter"><code>closure</code></em>. The <code class="literal">marshal_data</code>
of <em class="parameter"><code>marshal</code></em> provides a way for a meta marshaller to provide additional
information to the marshaller. (See <a class="link" href="gobject-Closures.html#g-closure-set-meta-marshal"><code class="function">g_closure_set_meta_marshal()</code></a>.) For
GObject's C predefined marshallers (the g_cclosure_marshal_*()
functions), what it provides is a callback function to use instead of
<em class="parameter"><code>closure-&gt;callback</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> function


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2978689"></a><h3>
<a name="g-closure-add-marshal-guards"></a>g_closure_add_marshal_guards ()</h3>
<a class="indexterm" name="id2978702"></a><pre class="programlisting">void                g_closure_add_marshal_guards        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> pre_marshal_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> pre_marshal_notify,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> post_marshal_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureNotify">GClosureNotify</a> post_marshal_notify);</pre>
<p>
Adds a pair of notifiers which get invoked before and after the closure 
callback, respectively. This is typically used to protect the extra arguments
for the duration of the callback. See <a class="link" href="gobject-The-Base-Object-Type.html#g-object-watch-closure"><code class="function">g_object_watch_closure()</code></a> for an
example of marshal guards.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pre_marshal_data</code></em>&#160;:</span></p></td>
<td>data to pass to <em class="parameter"><code>pre_marshal_notify</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pre_marshal_notify</code></em>&#160;:</span></p></td>
<td>a function to call before the closure callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>post_marshal_data</code></em>&#160;:</span></p></td>
<td>data to pass to <em class="parameter"><code>post_marshal_notify</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>post_marshal_notify</code></em>&#160;:</span></p></td>
<td>a function to call after the closure callback


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2978873"></a><h3>
<a name="g-closure-set-meta-marshal"></a>g_closure_set_meta_marshal ()</h3>
<a class="indexterm" name="id2978887"></a><pre class="programlisting">void                g_closure_set_meta_marshal          (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data,
                                                         <a class="link" href="gobject-Closures.html#GClosureMarshal">GClosureMarshal</a> meta_marshal);</pre>
<p>
Sets the meta marshaller of <em class="parameter"><code>closure</code></em>. 
A meta marshaller wraps <em class="parameter"><code>closure-&gt;marshal</code></em> and modifies the way it is called 
in some fashion. The most common use of this facility is for C callbacks. 
The same marshallers (generated by 
<a class="link" href="glib-genmarshal.html" title="glib-genmarshal">glib-genmarshal</a>) are used everywhere,
but the way that we get the callback function differs. In most cases we want 
to use <em class="parameter"><code>closure-&gt;callback</code></em>, but in other cases we want to use some 
different technique to retrieve the callback function.
</p>
<p>
For example, class closures for signals (see <a class="link" href="gobject-Signals.html#g-signal-type-cclosure-new"><code class="function">g_signal_type_cclosure_new()</code></a>) 
retrieve the callback function from a fixed offset in the class structure. 
The meta marshaller retrieves the right callback and passes it to the 
marshaller as the <em class="parameter"><code>marshal_data</code></em> argument.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>context-dependent data to pass to <em class="parameter"><code>meta_marshal</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>meta_marshal</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> function


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2979056"></a><h3>
<a name="g-source-set-closure"></a>g_source_set_closure ()</h3>
<a class="indexterm" name="id2979069"></a><pre class="programlisting">void                g_source_set_closure                (<a
href="./../glib/glib/glib-The-Main-Event-Loop.html#GSource"
>GSource</a> *source,
                                                         <a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure);</pre>
<p>
Set the callback for a source as a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>.
</p>
<p>
If the source is not one of the standard GLib types, the <em class="parameter"><code>closure_callback</code></em>
and <em class="parameter"><code>closure_marshal</code></em> fields of the <a
href="./../glib/glib/glib-The-Main-Event-Loop.html#GSourceFuncs"
><span class="type">GSourceFuncs</span></a> structure must have been
filled in with pointers to appropriate functions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>source</code></em>&#160;:</span></p></td>
<td>the source
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2979180"></a><h3>
<a name="G-TYPE-IO-CHANNEL:CAPS"></a>G_TYPE_IO_CHANNEL</h3>
<a class="indexterm" name="id2979194"></a><pre class="programlisting">#define G_TYPE_IO_CHANNEL (g_io_channel_get_type ())
</pre>
<p>
The <a class="link" href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> for <a
href="./../glib/glib/glib-IO-Channels.html#GIOChannel"
><span class="type">GIOChannel</span></a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2979226"></a><h3>
<a name="G-TYPE-IO-CONDITION:CAPS"></a>G_TYPE_IO_CONDITION</h3>
<a class="indexterm" name="id2979240"></a><pre class="programlisting">#define G_TYPE_IO_CONDITION (g_io_condition_get_type ())
</pre>
<p>
The <a class="link" href="gobject-Type-Information.html#GType"><span class="type">GType</span></a> for <a
href="./../glib/glib/glib-IO-Channels.html#GIOCondition"
><span class="type">GIOCondition</span></a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2979273"></a><h3>
<a name="g-cclosure-marshal-VOID--VOID"></a>g_cclosure_marshal_VOID__VOID ()</h3>
<a class="indexterm" name="id2979286"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__VOID       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>1
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding only the instance
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2979486"></a><h3>
<a name="g-cclosure-marshal-VOID--BOOLEAN"></a>g_cclosure_marshal_VOID__BOOLEAN ()</h3>
<a class="indexterm" name="id2979500"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__BOOLEAN    (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#gboolean"
><span class="type">gboolean</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2979708"></a><h3>
<a name="g-cclosure-marshal-VOID--CHAR"></a>g_cclosure_marshal_VOID__CHAR ()</h3>
<a class="indexterm" name="id2979722"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__CHAR       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gchar arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#gchar"
><span class="type">gchar</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2979931"></a><h3>
<a name="g-cclosure-marshal-VOID--UCHAR"></a>g_cclosure_marshal_VOID__UCHAR ()</h3>
<a class="indexterm" name="id2979944"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__UCHAR      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, guchar arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#guchar"
><span class="type">guchar</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2980153"></a><h3>
<a name="g-cclosure-marshal-VOID--INT"></a>g_cclosure_marshal_VOID__INT ()</h3>
<a class="indexterm" name="id2980166"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__INT        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gint arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2980375"></a><h3>
<a name="g-cclosure-marshal-VOID--UINT"></a>g_cclosure_marshal_VOID__UINT ()</h3>
<a class="indexterm" name="id2980388"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__UINT       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, guint arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#guint"
><span class="type">guint</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2980597"></a><h3>
<a name="g-cclosure-marshal-VOID--LONG"></a>g_cclosure_marshal_VOID__LONG ()</h3>
<a class="indexterm" name="id2980611"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__LONG       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, glong arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#glong"
><span class="type">glong</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2980819"></a><h3>
<a name="g-cclosure-marshal-VOID--ULONG"></a>g_cclosure_marshal_VOID__ULONG ()</h3>
<a class="indexterm" name="id2980833"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__ULONG      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gulong arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#gulong"
><span class="type">gulong</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2981041"></a><h3>
<a name="g-cclosure-marshal-VOID--ENUM"></a>g_cclosure_marshal_VOID__ENUM ()</h3>
<a class="indexterm" name="id2981055"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__ENUM       (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gint arg1, gpointer user_data)</code> where the <a
href="./../glib/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a> parameter denotes an enumeration type..
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the enumeration parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2981264"></a><h3>
<a name="g-cclosure-marshal-VOID--FLAGS"></a>g_cclosure_marshal_VOID__FLAGS ()</h3>
<a class="indexterm" name="id2981278"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__FLAGS      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gint arg1, gpointer user_data)</code> where the <a
href="./../glib/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a> parameter denotes a flags type
denotes a flags type.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the flags parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2981488"></a><h3>
<a name="g-cclosure-marshal-VOID--FLOAT"></a>g_cclosure_marshal_VOID__FLOAT ()</h3>
<a class="indexterm" name="id2981501"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__FLOAT      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#gfloat"
><span class="type">gfloat</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2981710"></a><h3>
<a name="g-cclosure-marshal-VOID--DOUBLE"></a>g_cclosure_marshal_VOID__DOUBLE ()</h3>
<a class="indexterm" name="id2981723"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__DOUBLE     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#gdouble"
><span class="type">gdouble</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2981932"></a><h3>
<a name="g-cclosure-marshal-VOID--STRING"></a>g_cclosure_marshal_VOID__STRING ()</h3>
<a class="indexterm" name="id2981946"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__STRING     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#gchar"
><span class="type">gchar</span></a>* parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2982154"></a><h3>
<a name="g-cclosure-marshal-VOID--PARAM"></a>g_cclosure_marshal_VOID__PARAM ()</h3>
<a class="indexterm" name="id2982168"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__PARAM      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a class="link" href="gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>* parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2982376"></a><h3>
<a name="g-cclosure-marshal-VOID--BOXED"></a>g_cclosure_marshal_VOID__BOXED ()</h3>
<a class="indexterm" name="id2982390"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__BOXED      (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <span class="type">GBoxed</span>* parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2982600"></a><h3>
<a name="g-cclosure-marshal-VOID--POINTER"></a>g_cclosure_marshal_VOID__POINTER ()</h3>
<a class="indexterm" name="id2982613"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__POINTER    (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
><span class="type">gpointer</span></a> parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2982822"></a><h3>
<a name="g-cclosure-marshal-VOID--OBJECT"></a>g_cclosure_marshal_VOID__OBJECT ()</h3>
<a class="indexterm" name="id2982836"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__OBJECT     (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, GOBject *arg1, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding the instance and the <a class="link" href="gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>* parameter
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2983044"></a><h3>
<a name="g-cclosure-marshal-STRING--OBJECT-POINTER"></a>g_cclosure_marshal_STRING__OBJECT_POINTER ()</h3>
<a class="indexterm" name="id2983059"></a><pre class="programlisting">void                g_cclosure_marshal_STRING__OBJECT_POINTER
                                                        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>3
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding instance, arg1 and arg2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2983260"></a><h3>
<a name="g-cclosure-marshal-VOID--UINT-POINTER"></a>g_cclosure_marshal_VOID__UINT_POINTER ()</h3>
<a class="indexterm" name="id2983274"></a><pre class="programlisting">void                g_cclosure_marshal_VOID__UINT_POINTER
                                                        (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>ignored
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>3
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding instance, arg1 and arg2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2983476"></a><h3>
<a name="g-cclosure-marshal-BOOLEAN--FLAGS"></a>g_cclosure_marshal_BOOLEAN__FLAGS ()</h3>
<a class="indexterm" name="id2983490"></a><pre class="programlisting">void                g_cclosure_marshal_BOOLEAN__FLAGS   (<a class="link" href="gobject-Closures.html#GClosure">GClosure</a> *closure,
                                                         <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *return_value,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#guint"
>guint</a> n_param_values,
                                                         const <a class="link" href="gobject-Generic-values.html#GValue">GValue</a> *param_values,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> invocation_hint,
                                                         <a
href="./../glib/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> marshal_data);</pre>
<p>
A marshaller for a <a class="link" href="gobject-Closures.html#GCClosure"><span class="type">GCClosure</span></a> with a callback of type
<code class="literal">gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)</code> where the <a
href="./../glib/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a> parameter
denotes a flags type.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>the <a class="link" href="gobject-Closures.html#GClosure"><span class="type">GClosure</span></a> to which the marshaller belongs
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>return_value</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> which can store the returned <a
href="./../glib/glib/glib-Basic-Types.html#gboolean"
><span class="type">gboolean</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_param_values</code></em>&#160;:</span></p></td>
<td>2
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>param_values</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> array holding instance and arg1
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>invocation_hint</code></em>&#160;:</span></p></td>
<td>the invocation hint given as the the last argument
  to <a class="link" href="gobject-Closures.html#g-closure-invoke"><code class="function">g_closure_invoke()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>marshal_data</code></em>&#160;:</span></p></td>
<td>additional data specified when registering the marshaller


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2983714"></a><h3>
<a name="g-cclosure-marshal-BOOL--FLAGS"></a>g_cclosure_marshal_BOOL__FLAGS</h3>
<a class="indexterm" name="id2983728"></a><pre class="programlisting">#define             g_cclosure_marshal_BOOL__FLAGS</pre>
<p>
Another name for <a class="link" href="gobject-Closures.html#g-cclosure-marshal-BOOLEAN--FLAGS"><code class="function">g_cclosure_marshal_BOOLEAN__FLAGS()</code></a>.
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2983757"></a><div class="refsect2" lang="en"><a name="id2983758"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id2983759"></a></div>
</div>
</div>
</body>
</html>
